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Status of this Memo 
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1. Introduction 


This memo defines an extension to the Management Information Base 
(MIB) for use with network management protocols in the Internet 
community. In particular, it defines objects for the management of 
coffee-brewing and maintenance devices. 


2. The SNMPv2 Network Management Framework 


The SNMPv2 Network Management Framework consists of four major 
components. They are: 


fe) RFC 1442 [1] which defines the SMI, the mechanisms used for 
describing and naming objects for the purpose of management. 
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(0) STD 17, RFC 1213 [2] defines MIB-II, the core set of managed 
objects for the Internet suite of protocols. 


fe) RFC 1445 [3] which defines the administrative and other 
architectural aspects of the framework. 


fe) RFC 1448 [4] which defines the protocol used for network 
access to managed objects. 


The Framework permits new objects to be defined for the purpose of 
experimentation and evaluation. 


2.1. Object Definitions 


Managed objects are accessed via a virtual information store, termed 
the Management Information Base or MIB. Objects in the MIB are 
defined using the subset of Abstract Syntax Notation One (ASN.1) 
defined in the SMI. In particular, each object object type is named 
by an OBJECT IDENTIFIER, an administratively assigned name. The 
object type together with an object instance serves to uniquely 
identify a specific instantiation of the object. For human 
convenience, we often use a textual string, termed the descriptor, to 
refer to the object type. 


3. Overview 


The COFFEE POT MIB applies to managed devices that brew, store, and 
deliver heated coffee beverages. The COFFEE POT MIB is mandatory for 
all systems that have such a hardware port supporting services 
managed through some other MIB. 


The MIB contains objects that relate to physical connections, 
configuration, storage levels, availabilty, quality of service, and 
availability. 


3.1. Relationship to Interface MIB 


The COFFEE-POT-MIB is one of many MIBs designed for layered use as 
described in the Interface MIB [5]. In most implementations where it 
is present, it will be in the lowest interface sublayer, that is, the 
COFFEE-POT-MIB represents the physical layer, providing service to 
higher layers such as the Character MIB [6]. 


Although it is unlikely that a coffee port will actually be used as a 
network interface, which is the intent of the Interface MIB, the 
COFFEE-POT-MIB is closely connected to the Character MIB, which can 
share hardware interfaces with network operation, and relate to the 
RS-232 MIB [7]. 
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The Interface MIB’s ifTestTable and ifRcvAddressTable are not 
relevant to the COFFEE-POT-MIB. 


The COFFEE-POT-MIB is relevant for ifType values sip(31), and perhaps 
others. 


The COFFEE-POT-MIB requires the conformance groups ifGeneralGroup, 
and ifFixedLengthGroup. 


Usefulness of error counters in this MIB depends on the octet 
counters in ifFixedLengthGroup. 


4. Definitions 
COFFEE-POT-MIB DEFINITIONS ::= BEGIN 


IMPORTS 
MODULE-IDENTITY, OBJECT-TYPE, NOTIFICATION-TYPE, 
TimeStamp, TimelInterval, 
Counter32, Integer32 
FROM SNMPv2-SMI 
InterfaceIndex 
FROM IF-MIB 
transmission 
FROM RFC1213-MIB 
MODULE-COMPLIANCE, OBJECT-GROUP 
FROM SNMPv2-CONF; 


coffee MODULE-IDENTITY 
LAST-UPDATED "98032317002" 
ORGANIZATION "Networked Appliance Management Working Group" 


CONTACT-INFO 
7 Michael Slavitch 
Loran Technologies, 
955 Green Valley Crescent 
Ottawa, Ontario Canada K2A 0B6 


Tel: 613-723-7505 
Fax: 613-723-7209 
E-mail: slavitch@loran.com" 
DESCRIPTION 
"Ihe MIB Module for coffee vending devices." 
:= { transmission 132 } 


potName OBJECT-TYPE 


SYNTAX DisplayString (SIZE (0..255)) 
MAX-ACCESS read-only 
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STATUS current 
DESCRIPTION 


"The vendor description of the pot under management" 
::= { coffee 1 } 


potCapacity OBJECT-TYPE 
SYNTAX Integer32 
MAX-ACCESS read-only 
STATUS current 
DESCRIPTION 
"The number of units of beverage supported by this device 
(regardless of its current state) ." 
::= { coffee 2 } 


potType OBJECT-TYPE 
SYNTAX INTEGER { 
automatic-drip (1), 
percolator (2), 
french-press (3), 
espresso (4), 
} 
MAX-ACCESS read-write 
STATUS current 
DESCRIPTION 
"The brew type of the coffee pot." 
::= { coffee 3 } 


potLocation OBJECT-TYPE { 
SYNTAX DisplayString (SIZE (0..255)) 
MAX-ACCESS read-write 
STATUS current 
DESCRIPTION 
"The physical location of the pot in question" 
::= { coffee 4 } 


potMonitor OBJECT IDENTIFIER ::= { coffee 6 } 
potOperStatus 
SYNTAX Integer { 
off(1), 


brewing(2), 
holding(3), 
other (4), 
waiting (5) 
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} 

MAX-ACCESS read-only 

STATUS current 

DESCRIPTION 
"The operating status of the pot in question. Note 
that this is a read-only feature. Current hardware 
prevents us from changing the port state via SNMP." 

:= { potMonitor 1 } 


potLevel OBJECT-TYPE 

SYNTAX Integer32 

MAX-ACCESS read-only 

STATUS current 

DESCRIPTION 
"The number of units of coffee under management. The 
units of level are defined in potMetric below." 

::= { potMonitor 2 } 


potMetric OBJECT-TYPE 
SYNTAX Integer { 
espresso (1), 
demi-tasse (2), 
cup (3), 
mug (4), 
bucket (5) 
} 
MAX-ACCESS read-only 
STATUS current 
DESCRIPTION 
"Ihe vendor description of the pot under management" 
::= { potMonitor 3 } 


potStartTime OBJECT-TYPE 

SYNTAX Integer64 

MAX-ACCESS read-write 

STATUS current 

DESCRIPTION 
"The time in seconds since Jan 1 1970 to start the pot 
if and only if potOperStatus is waiting(5)" 

::= { potMonitor 4 } 


lastStartTime OBJECT-TYPE 
SYNTAX TimeInterval 
MAX-ACCESS read-only 
STATUS current 
DESCRIPTION 
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"The amount of time, in TimeTicks, since the coffee 
making process was initiated." 
::= { potMonitor 5 } 


potTemperature OBJECT-TYPE 


END 


SYNTAX Integer32 
UNITS "degrees Centigrade" 
MAX-ACCESS read-only 
STATUS current 
DESCRIPTION 
"The ambient temperature of the coffee within the pot" 


::= { potMonitor 6 } 
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7. Security Considerations 


Security issues are not discussed in this memo. 
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Full Copyright Statement 
Copyright (C) The Internet Society (1998). All Rights Reserved. 


This document and translations of it may be copied and furnished to 
others, and derivative works that comment on or otherwise explain it 
or assist in its implementation may be prepared, copied, published 
and distributed, in whole or in part, without restriction of any 
kind, provided that the above copyright notice and this paragraph are 
included on all such copies and derivative works. However, this 
document itself may not be modified in any way, such as by removing 
the copyright notice or references to the Internet Society or other 
Internet organizations, except as needed for the purpose of 
developing Internet standards in which case the procedures for 
copyrights defined in the Internet Standards process must be 
followed, or as required to translate it into languages other than 
English. 


The limited permissions granted above are perpetual and will not be 
revoked by the Internet Society or its successors or assigns. 


This document and the information contained herein is provided on an 
"AS IS" basis and THE INTERNET SOCIETY AND THE INTERNET ENGINEERING 
TASK FORCE DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING 
BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION 
HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF 
MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. 
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